                               Foundation Developer Notes

                   for the Foundation Developers Kit 1.0b7cd

                                    Copyright, 1991-1992
                                       Lunar Productions
                                     All Rights Reserved

                   Marc Wolfgram, Mark Collins & Jim Murphy
                                          March 2, 1992


      IMPORTANT  -  FOUNDATION WILL NOT WORK PROPERLY ON READ-ONLY MEDIA !


This developer kit consists of the following Files:

        Read.Me                 This file in Teach format.

        Foundation              The Foundation Shell

        Documentation           Folder containing-
            Read.Me.Txt         This file in TXT format.
            F.User.Guide        Preliminary Shell Users Manual For Developers.
            F.Editor.Ref        The Foundation Editor Tech Reference.
                                This file describes how to write your own
                                editors for Foundation.
            F.Callback.Ref      The Foundation Editor Callback Reference.
                                This file documents the editor callback
                                functions provided in the Foundation Shell.

        Essentials              Folder containing-
            Foundation.h        ORCA/C header file for resource editors.
                                Compatible with APW C.
            Foundation.rez      APW Rez template describing the format of the
                                Foundation-specific resource types.
            M16.Foundation      ASM65816 Macros for the Foundation callbacks.
            REMHeader.asm       ASM65816 source for the resource editor header
                                providing the standard editor/shell interface.
            REMHeader.root      Prebuilt object code for the editor header.
                                Compatible with APW C and ORCA/C and Pascal.

        Foundation.Edit         Folder containing the editors-
            HexREM              The HexEdit/ScriptEdit Resource Editor Module.

        Foundation.User         Folder containing-
            Foundation.Data     This file contains Shell's user preferences,
                                user-defined ScriptEdit scripts,and is the
                                place where editors may save their user data.
            workFile.a ... d    These files are copies of any files open for
                                editing and are created by Foundation.


Release Notes for 1.0b7


        The following menu items are non-functional in this release:

            Apple Menu:         Help (Debugger Window opens on Option-Help)
            File Menu:          Make Reference File
                                Optimize File
            Add Type menu:      Import Data

        These Type Window functions are also non-functional:

                        Export Item
                        Find Parent
                        Find Children

        Intelligent clipboard support is not implemented in this release.

        The HexEdit/ScriptEdit module is the only Resource Editor Module
        currently provided.

        While HexEdit is just about complete, there is a known problem involving
        updating or scrolling areas of less than eight pixels wide. The right edge
        code works correctly, but there is a subtle bug in the left edge code.  For
        this release it has been disabled. 

        There are several keyboard actions supported by HexEdit:
                Delete          Removes the byte to the left of the cursor.
                Clear           Removes the byte that the cursor is hilighting.
                Arrow Keys      Navigate one byte in the respective direction.
                Control  C      Copies the currently selected byte to the
                                clipboard.
                Control  V      Pastes any byte previously copied to the
                                clipboard directly before the current insertion
                                location.
                Tab             Switches the primary target of user keystrokes
                                between the Hex and ASCII sides.
                Command-E       Toggles between Overstrike mode (solid block
                                cursor on the primary side), and Insert mode
                                (flashing vertical bar).

________________________________________________________________________________

Well, that's about it for now.  Welcome to the world of Foundation and resource
development.  We hope you are as excited as we are.  If you have any questions,
suggestions, ideas, etc., feel free to contact us via the online services or
through the mail.

There is a special private area for discussion and updates for Foundation on
GEnie's A2Pro, and we hope to open a Direct Connect support area soon on
America Online as well.


Thank you for your support.


        Lunar Productions...

                        Marc Wolfgram
                                Mark Collins
                                        Jim Murphy


Acknowledgements and Thanks go to the following:

            Rob Barnes              Dave Lyons
            Greg Branche            Andy Nicholas
            Matt Deatherage         Mike Nuzzi
            Paul Elseth             Tom Weishaar
            Michael Hackney         Mike Westerfield
            Ron Lichty              Tammy Wolfgram

        The Great folks at Apple II DTS & Engineering

Special thanks go especially to:

        Tim Swihart... for all championing the IIGS and encouraging us.
        Issac Asimov... thank you for many enjoyable hours of distraction.

And now for the obligatories:

        The Foundation Project, Foundation I, Foundation II, Foundation III,
        HexEdit and ScriptEdit, are trademarks of Lunar Productions.

        Apple and a whole lot of other terms are trademarks and registered
        trademarks of Apple Computer, Inc.

        This software, documentation and related materials are all Copyright
        (c) 1991-1992 by Lunar Productions. All Rights Reserved.

        Foundation and HexREM were written using ORCA/M and ORCA/C, which means
        that Byte Works gets these plugs:

                This program contains material from the ORCA/C
                Run-Time Libraries, copyright 1987-1989
                by Byte Works Inc.  Used with permission.

                Contains libraries from ORCA/M, Copyright 1991, Byte Works, Inc.

        Apple Computer Inc. makes no warranties, either expressed or implied,
        regarding the enclosed computer software package, its merchantability 
        or its fitness for any particular purpose.  The exclusion of implied
        warranties is not permitted by some states.  The above exclusion may not
        apply to you.  This warranty provides you with specific legal rights.  
        There may be other rights you may have which vary from state to state.

For more information, updates notices, and technical support, contact us at:

        Lunar Productions                       AppleLink: D3672
        1808 Michael Drive         -or-         AOL: M Wolfgram
        Waukesha, WI 53186                      GEnie: A2Pro.Mark
